iT邦幫忙

2024 iThome 鐵人賽

DAY 3
0
Modern Web

蓋一個自己的 Nuxt 3 UI Module系列 第 3

元件製作 button

  • 分享至 

  • xImage
  •  

按鈕狀態

製作按鈕前要先規劃按鈕會有哪些狀態,與其在不同狀態下的樣式

例如:

  1. hover: 當滑鼠移動到上面的狀態
  2. active: 當使用者點下後的狀態
  3. focus: 使用者使用鍵盤 tab 鍵選取目標的狀態
  4. disable: 當按鈕不可以操作時的狀態

實作

  • step 1: 建立資料夾 components/global/ , Nuxt 預設 global 資料夾下的元件為全域
    https://nuxt.com/docs/guide/directory-structure/components

  • step 2: 新增檔案 button.vueglobal 資料夾下

    • 首先定義按鈕的狀態與型別,透過 props 方式來控制按鈕的狀態,並使用 withDefaults() 給予預設值
    • 這邊我預留了 btnClass 這個來控制 button 的顏色與樣式
    // button.vue
    <script lang="ts" setup>
    
    /** 定義按鈕型別 */
    export interface ButtonPropsType {
      /** 按鈕文字 */
      text?: string
      /** 是否 不可點擊 */
      isDisabled?: boolean
      /** 是否 載入狀態 */
      isLoading?: boolean
      /** 按鈕 外觀樣式 */
      btnClass?: string
      /** 按鈕 icon */
      icon?: string
      /** icon 樣式 */
      iconClass?: string
    }
    
    withDefaults(defineProps<ButtonPropsType>(), {
      text: '',
      isDisabled: false,
      isLoading: false,
      btnClass: 'bg-primary-600 text-white',
      icon: '',
      iconClass: 'text-[20px]',
    })
    </script>
    
    
    • 以下是按鈕的樣式~
    // button.vue
    <template>
      <button
        :disabled="isDisabled"
        class="btn"
        :class="`
        ${isLoading ? 'pointer-events-none' : ''}
        ${isDisabled ? 'cursor-not-allowed pointer-events-none' : ''}
        ${btnClass}
        `"
      >
        <template v-if="!isLoading && !$slots.default">
          <span class="flex items-center">
            <span
              v-if="icon"
              :class="`
              ${iconClass}
              `"
            >
              <Icon :name="icon"/>
            </span>
            <span v-if="text">{{ text }}</span>
          </span>
        </template>
        <template v-if="isLoading">
          <Icon name="svg-spinners:tadpole" class="size-5 mr-2" />
          Loading ...
        </template>
        <div v-if="$slots.default && !isLoading">
          <slot />
        </div>
      </button>
    </template>
    <style scoped>
    .btn {
      /** 樣式設定 */
    }
    </style>
    
  • step 3: 最後整理一下,在 pages/ 下新建立一個 button 頁面來呈現剛剛做好的 button元件 ~

    // pages/button.vue
    <template>
      <div class="flex items-center gap-x-2">
        <Button text="primary" isLoading />
        <Button text="primary" isDisabled />
        <Button text="Reward" icon="mingcute:award-fill" iconClass="text-yellow-500 mr-2" />
        <Button text="primary" />
      </div>
    </template>
    

    最後完成的樣子就是這樣囉~


上一篇
安裝 nuxt-icon
下一篇
元件製作 input
系列文
蓋一個自己的 Nuxt 3 UI Module30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言